|
OpenStack Queens : How to use Swift
2018/03/08 |
|
This section shows how to use Swift Storage from Clients.
This example is based on the emvironment like follows.
-+---------------+----------------------------+----------------------------+------------
| | | |
| eth0|10.0.0.30 eth0|10.0.0.50 eth0|10.0.0.61
| +-----------+-----------+ +-----------+-----------+ +-----------+-----------+
| | [ Control Node ] | | [ Proxy Node ] | | [ Client ] |
| | | | | | |
| | MariaDB RabbitMQ | | Swift Proxy | | Swift Client |
| | Memcached httpd | | | | |
| | Keystone | | | | |
| +-----------------------+ +-----------------------+ +-----------------------+
|
+---------------+----------------------------+----------------------------+---------
eth0|10.0.0.71 eth0|10.0.0.72 eth0|10.0.0.73
+-----------+-----------+ +-----------+-----------+ +-----------+-----------+
| [ Storage Node#1 ] | | [ Storage Node#2 ] | | [ Storage Node#3 ] |
| | | | | |
| Swift-Account | | Swift-Account | | Swift-Account |
| Swift-Container | | Swift-Container | | Swift-Container |
| Swift-Object | | Swift-Object | | Swift-Object |
+-----------------------+ +-----------------------+ +-----------------------+
|
| [1] | Add a user for using Swift on Keystone Control Node. By the way, if you'd like to use Swift Quickly, it's unnecessarry to add a new user, it's posibble to use with existing admin or swift user on Keystone. |
|
# add swiftservice project [root@dlp ~(keystone)]# openstack project create --domain default --description "Swift Service Project" swiftservice +-------------+----------------------------------+ | Field | Value | +-------------+----------------------------------+ | description | Swift Service Project | | domain_id | default | | enabled | True | | id | 7366c0bedab94c85ba20886e6e2ac43a | | is_domain | False | | name | swiftservice | | parent_id | default | | tags | [] | +-------------+----------------------------------+ # add SwiftOperator role [root@dlp ~(keystone)]# openstack role create SwiftOperator +-----------+----------------------------------+ | Field | Value | +-----------+----------------------------------+ | domain_id | None | | id | 580be21e13f64bfa81d046cc3f66a4d3 | | name | SwiftOperator | +-----------+----------------------------------+ # add a user [root@dlp ~(keystone)]# openstack user create --domain default --project swiftservice --password userpassword swiftuser01
+---------------------+----------------------------------+
| Field | Value |
+---------------------+----------------------------------+
| default_project_id | 7366c0bedab94c85ba20886e6e2ac43a |
| domain_id | default |
| enabled | True |
| id | 4a1ed839fea64af9bf4994195ae5a6d4 |
| name | swiftuser01 |
| options | {} |
| password_expires_at | None |
+---------------------+----------------------------------+
# add the user in SwiftOperator role [root@dlp ~(keystone)]# openstack role add --project swiftservice --user swiftuser01 SwiftOperator
|
| [2] | Work on a Client from here and later. Install Keystoneclient, Swiftclient on a Client first. |
|
[root@client ~]# yum --enablerepo=centos-openstack-queens,epel -y install python-openstackclient python-keystoneclient python-swiftclient
|
| [3] | Load environment variables first. ( it's just the value for a user added in [1] ) |
|
[root@client ~]#
vi ~/keystonerc_swift
export OS_PROJECT_DOMAIN_NAME=default
export OS_USER_DOMAIN_NAME=default export OS_PROJECT_NAME=swiftservice export OS_USERNAME=swiftuser01 export OS_PASSWORD=userpassword export OS_AUTH_URL=http://10.0.0.30:5000/v3 export OS_IDENTITY_API_VERSION=3 export PS1='[\u@\h \W(swift)]\$ '
[root@client ~]#
chmod 600 ~/keystonerc_swift [root@client ~]# source ~/keystonerc_swift [root@client ~(swift)]# echo "source ~/keystonerc_swift " >> ~/.bash_profile
# show status [root@client ~(swift)]# swift stat
Account: AUTH_7366c0bedab94c85ba20886e6e2ac43a
Containers: 0
Objects: 0
Bytes: 0
X-Put-Timestamp: 1520580700.25872
X-Timestamp: 1520580700.25872
X-Trans-Id: txa9cf7377c21c40ceadf61-005aa2385c
Content-Type: text/plain; charset=utf-8
X-Openstack-Request-Id: txa9cf7377c21c40ceadf61-005aa2385c
|
| [4] | Create a Container for saving files. |
|
[root@client ~(swift)]# openstack container create test_container +---------------------------------------+----------------+------------------------------------+ | account | container | x-trans-id | +---------------------------------------+----------------+------------------------------------+ | AUTH_7366c0bedab94c85ba20886e6e2ac43a | test_container | tx538d8fee4a9646c08d9c8-005aa2386e | +---------------------------------------+----------------+------------------------------------+[root@client ~(swift)]# openstack container list +----------------+ | Name | +----------------+ | test_container | +----------------+ |
| [5] | Upload a file on local to the Container. |
|
# upload test.txt [root@client ~(swift)]# openstack object create test_container test.txt +----------+----------------+----------------------------------+ | object | container | etag | +----------+----------------+----------------------------------+ | test.txt | test_container | f07235ceb02e4b661767db9bcfbe0be1 | +----------+----------------+----------------------------------+[root@client ~(swift)]# openstack object list test_container +----------+ | Name | +----------+ | test.txt | +----------+ |
| [6] | Download a file from Swift Storage to local. |
|
[root@client ~(swift)]# openstack object save test_container test.txt [root@client ~(swift)]# total 36 -rw-------. 1 root root 1437 Feb 8 13:54 anaconda-ks.cfg -rw-------. 1 root root 283 Mar 9 16:31 keystonerc_swift -rw-r--r--. 1 root root 10 Mar 9 16:33 test.txt |
| [7] | Delete a file on Swift Storage. |
|
[root@client ~(swift)]# openstack object delete test_container test.txt [root@client ~(swift)]# openstack object list test_container # test.txt is deleted |
| [8] | Delete a Container on Swift Storage. |
|
[root@client ~(swift)]# openstack container delete test_container [root@client ~(swift)]# openstack container list # test_container is deleted
|